home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / getprojall.z / getprojall
Encoding:
Text File  |  2002-10-03  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttpppprrrroooojjjjaaaallllllll((((3333cccc))))                                                  ggggeeeettttpppprrrroooojjjjaaaallllllll((((3333cccc))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      getprojall, fgetprojall - enumerate all project IDs
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<pppprrrroooojjjj....hhhh>>>>
  13.  
  14.      iiiinnnntttt ggggeeeettttpppprrrroooojjjjaaaallllllll((((pppprrrroooojjjjiiiidddd____tttt ****bbbbuuuuffff,,,, iiiinnnntttt lllleeeennnn))));;;;
  15.  
  16.      iiiinnnntttt ffffggggeeeettttpppprrrroooojjjjaaaallllllll((((PPPPRRRROOOOJJJJ ttttooookkkkeeeennnn,,,, pppprrrroooojjjjiiiidddd____tttt ****bbbbuuuuffff,,,, iiiinnnntttt lllleeeennnn))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      The _g_e_t_p_r_o_j_a_l_l function stores information about all of the project IDs
  20.      known to the system into an array of pppprrrroooojjjjiiiidddd____tttt structs pointed to by _b_u_f.
  21.      A maximum of _l_e_n entries will be stored.  The pppprrrroooojjjjiiiidddd____tttt struct is defined
  22.      in <<<<pppprrrroooojjjj....hhhh>>>> and has the following format:
  23.  
  24.           #define MAXPROJNAMELEN 32
  25.           typedef struct projid {
  26.                   char    proj_name[MAXPROJNAMELEN];      /* project name */
  27.                   prid_t  proj_id;                        /* project ID */
  28.           } projid_t;
  29.  
  30.      Note that project names that have more than MMMMAAAAXXXXPPPPRRRROOOOJJJJNNNNAAAAMMMMEEEELLLLEEEENNNN-1 characters
  31.      will be truncated.  The _pppp_rrrr_oooo_jjjj______nnnn_aaaa_mmmm_eeee field is always null-terminated.
  32.  
  33.      The _f_g_e_t_p_r_o_j_a_l_l function is a variant of _g_e_t_p_r_o_j_a_l_l that uses a PPPPRRRROOOOJJJJ
  34.      token to make it more efficient for repeated use.  Otherwise its
  35.      operation is identical.  For more details on creating a PPPPRRRROOOOJJJJ token, see
  36.      _o_p_e_n_p_r_o_j(3C).
  37.  
  38. FFFFIIIILLLLEEEESSSS
  39.      ////eeeettttcccc////pppprrrroooojjjjiiiidddd    System project name to project ID mappings.
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      closeproj(3C), getprojuser(3C), openproj(3C), projid(3C), projname(3C),
  43.      projid(4), projects(5).
  44.  
  45. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  46.      _g_e_t_p_r_o_j_a_l_l and _f_g_e_t_p_r_o_j_a_l_l both return the number of pppprrrroooojjjjiiiidddd____tttt's stored
  47.      (which may be 0 if the none are defined for the system) or -1 if an error
  48.      occurred.
  49.  
  50. BBBBUUUUGGGGSSSS
  51.      All of the functions use _f_o_p_e_n(3S) and are thus subject to its
  52.      limitations.
  53.  
  54.      Project ID information should be (optionally) obtained via NIS.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.